Γùè This utility is distributed as shareware: if you like it please honor the shareware system by sending $5 to the author at the address above. Since cashing international cheques is very expensive, please send cash only (U.S. dollars are best, but any other currency is fine).
Γùè If you work on the Macintosh, there are many things you can send me instead of the money. Here are some suggestions: original software (but don't send any shareware/freeware unless you're the author), books or computer-related magazines (any free issue or subscription is welcome), CD-ROMs, any piece of new or used hardware, or anything else you've created.
Γùè There's still another thing you could do: I'll finish my physics studies sometime in 1996 and I'm looking for a one-year job as a programmer (or maybe a scientist?) outside of Italy. Let me know if you have anything to offer.
Γùè If you can't afford any of the above an e-mail, a postcard or a letter is welcome. I speak English, French and Italian. Please forgive me if I don't answer to all of your letters - I am often overloaded with my school work.
ΓÇó Introduction
Γùè List Files is a handy utility that creates a text catalog of anything you drop on it. You can format the text in many ways and set up file filters to look for specific files. You may create different worksets that can be recalled either from a menu or by holding down some keys when you drop things on List FilesΓÇÖ icon, so you can switch between cataloging your floppies and searching for big text files in a flash. List Files can save your catalogs automatically to different destination folders, so you donΓÇÖt have to save them manually for every disk or cartridge you want to list. It can also search entire folders very quickly to find a specific file inside one of your catalogs.
Γùè List Files lets you edit your file lists, even though it can only display 32K of text in its windows (this is a limitation of TextEdit, the part of the Mac OS that handles text). The size of the lists, however, is only limited by the memory you assign to the application in the FinderΓÇÖs ΓÇ£Get InfoΓÇ¥ window. YouΓÇÖll probably have to increase the standard 256K partition if you plan to catalog CD-ROMs or very large hard disks. Long lists can be saved to disk and viewed with a true text editor or with a word processor.
Γùè I worked very hard to make List Files as compatible as possible; it takes full advantage of System 7ΓÇÖs new features, yet runs on any older system starting from System 4.2. It also handles system errors and low-memory situations gracefully, and has been tested on a very wide range of system configurations.
Γùè List Files adheres as closely as possible to AppleΓÇÖs human interface guidelines. I didnΓÇÖt stuff it with color pictures, weird sounds and fancy buttons so youΓÇÖll have a shorter download time and less wasted space on crowded disks. If you open List Files with ResEdit and take a look at its resources, youΓÇÖll notice that 50 out of its 84K are plain code and most of the rest is taken by this text.
◊ List Files is a commercial-quality application at the price of a magazine. I don’t like passwords, annoying messages and time limitations in my programs so I didn’t use any of them to enforce the shareware fee. Also, I’m asking very little because I feel that many small contributions are better than a few big ones; by keeping the price so low, I hope that many of you will take the time to fill the registration form and mail it with some spare change. If you feel this application is worth more than $5 or if you want to register more than one copy, I won’t complain…
ΓÇó Instructions
Γùè File menu:
- New List: lets you select a disk, a folder or a file and build its catalog. The current scanning, formatting and saving options are used along with the chosen file filters. This is the same as dropping stuff on top of List FilesΓÇÖ icon under System 7.
- Open Text: lets you open a text file and display it in a text window. Only the first 32K of text are shown if the file is larger than 32K.
- Close: closes the frontmost window.
- Save: saves the text of the frontmost window to disk.
- Save As…: same as Save, but you can save the text under a different name.
- Quit: closes all windows after checking for unsaved text and quits.
Γùè Edit menu:
- Cut, Copy, Paste, Clear and Select All behave as usual.
- Undo works in all text windows.
Γùè Options menu:
- Folder Scanning…: brings up a dialog where you can edit some scanning and listing options. “List dropped disks and folders in a single file” is useful under System 7 if you want to drop many items together on List Files’ icon and have them all listed in the same window.
- List Formatting…: lets you edit some text formatting options. “Header for listed files/folders” means that each file/folder dropped on List Files’ icon will have a small header showing the used and free space on the file’s disk, a full pathname to the file and the number and size of files and folders that matched the chosen filters. Full pathnames are useful if you’re searching for specific files and don’t want to see the whole hierarchy of folders listed (you may also want to disable the “Show Folders” check box in the list filters dialog). Pathnames in reversed form can be sorted (with a sorting capable text editor) and make it easy to find duplicate files.
- File Saving…: lets you change the destination folder for the auto-save option, the text file creator (i.e. the text editor or word processor you’ll use to open the catalogs) and other useful file naming and file saving preferences.
- Prefix / Suffix…: lets you enter smart prefix and suffix strings to use for each file and folder listed.
- Edit List Filters…: lets you specify some conditions for the files to be shown in the list. You can force conditions on the file kind, size, visibility, type and creator. All filters can be saved in a workset together with the other options, so you can easily build different setups for each of your file scanning needs.
- Clear List Filters…: clears the current file filters; all files and folders will be included in the next list.
- Skip Save Warnings: prevents List Files from asking if you want to save unsaved lists when their window is closed.
Γùè Worksets menu:
- Save Current Setup To…: saves the current setup (i.e. all of the settings you can change from the Options menu) to one of the user-defined worksets. You will be prompted for a new workset name before the setup is written to the workset.
- Define Modifier Keys…: List Files checks the Command, Option and Control keys when you drop something on its icon and when you start a new list; every combination of these keys can be assigned to a specific workset. The “default” assignment is only used when no keys are held down at launch time: you can choose a default workset or tell the application to keep using the setup it was using when the previous session ended.
- Worksets (names defined by user): selecting a workset name from the menu will immediately change the current setup to the chosen workset. All the options, including destination folders and file filters, will be modified to match those saved into the workset.
Γùè Text menu:
- Font: changes the text font in the frontmost window.
- Size: changes the text size in the frontmost window.
- Wrap: toggles text wrapping in the frontmost window.
- Set Default: saves the text font, text size and wrap mode of the frontmost window as default settings to be used when new text windows are created.
Γùè Find menu:
- Find…: finds a string in the frontmost window.
- Find Again: repeats the search for a previously entered string.
- Enter Selection: uses the text currently selected in the frontmost window as the search string.
- Find in Folder…: searches all text files in a given folder (the folder to search is saved in the worksets).
- Folder to Search…: lets you change the folder to search without actually searching a string.
- Display Selected File: quickly opens the text file whose pathname is selected in the front window.
ΓÇó Technical notes
Γùè The Command, Option and/or Control keys should be held down until the ΓÇ£Building file listΓÇ¥ dialog comes out (holding them down when you drop something on List FilesΓÇÖ icon and releasing them right away wonΓÇÖt work).
Γùè The total size shown in headers and folder subtotals is a physical size (space used on disk), whereas the size shown for each file is a logical size (actual size of the file).
Γùè All total sizes (except the diskΓÇÖs used and free space in the header) are based on found files, not on the actual files on disk. If youΓÇÖre listing invisible files only with no nested folders scanning, the total size in a folder subtotal is the size of all and only the invisible files inside that folder, but not inside any nested folders.
ΓÇó Compatibility notes
Γùè PowerPC: List Files is a fat binary, containing both 680x0 and native PowerPC code.
Γùè System 7.5: List Files has been extensively tested with System 7.5.
Γùè System 7: You can use List Files as a drop box under System 7 or later. Just drop one or more disks, folders or files on its icon to have them listed or searched. List Files takes full advantage of Apple Events and the new file routines when used under System 7, and it can build lists in the background while you keep working with other applications.
Γùè System 6: List Files is fully compatible with System 6, although it canΓÇÖt be switched to the background there. YouΓÇÖll have to create file lists with the ΓÇ£New ListΓÇ¥ menu command since drag&drop is not available, but everything else works as expected.
Γùè System 4: You wonΓÇÖt believe this one. You can even use List Files on a floppy-based Mac running System 4.2 or later, and youΓÇÖll get the same cool lists youΓÇÖd get with System 7.5.
ΓÇó Distribution
◊ List Files is ©1994-95 Alessandro Levi Montalcini. It can be freely distributed as long as it is not modified and there’s no charge for it, but it may not be included in any commercial package without my consent.
Γùè You may find the latest version of all my shareware programs by anonymous ftp to ftp.alpcom.it, inside the /software/mac/LMontalcini directory. The complete ShareDisk package, which contains all my stuff and can be registered at a very low price, is also available there.
Γùè All online services and bulletin boards may make it available to their users at no charge other than the normal connection fees.
Γùè All non-profit user groups may distribute it at no charge.
Γùè All magazines may publish it on floppy disk without asking me first, as long as I get a copy of the issue containing my software.
Γùè All CD-ROM shareware collections and CD-ROM magazines may include it without my prior consent, as long as I get either a copy of the CD-ROM or an offer to buy the CD-ROM at a discounted price.
Γùè All redistribution companies such as Educorp may distribute it, as long as I get a copy of each media containing my software and a catalog of the companyΓÇÖs offerings (where applicable).
ΓÇó Version history
Γùè 2.5.3 - Fixed a small bug in the ΓÇ£openΓÇ¥ and ΓÇ£saveΓÇ¥ dialogs.
Γùè 2.5.2 - Added a useful set of default worksets to get started with. Added a new prefix/suffix control sequence to list an itemΓÇÖs name, which is useful when creating HTML references. Raised the 31 characters limit on prefixes and suffixes to 255 characters. Fixed a bug in the PowerPC code which caused crashes on some of the preferences dialogs.
Γùè 2.5.1 - New option to skip the save dialogs when a list is closed.
Γùè 2.5 - List Files can now scan disks and search text files in the background. The progress and configuration dialogs are movable. New option to show elapsed time. Fixed various interface and file-saving issues.
Γùè 2.4.1 - Cleaned up some code and updated documentation.
Γùè 2.4 - List Files can now read file versions in both short and long formats and display them as part of a file prefix or suffix. Using prefixes and suffixes should also be slightly faster. Full pathnames donΓÇÖt disable indenting any more.
Γùè 2.3 - Added the Prefix/Suffix options for greater flexibility, as requested by Leroy Chen. The text windows now support the extended keyboardΓÇÖs scrolling keys.
Γùè 2.2 - Fat version, includes both 68000 and native PowerPC code. Accepts "open file" commands from AppleScript for disk and folder scanning. Only lists invisible folders when scanning for invisible files. Saves this documentation as styled text.
Γùè 2.1 - Added Find commands and fast folder search. Tracking files is now easier than ever!
Γùè 2.0 - Faster, better, and a lot more useful. Tens of options added, lots of code rewritten.
Γùè 1.1 - New auto-save option added (never released because 2.0 was on the way).
Γùè 1.01 - Recompiled with SymantecΓÇÖs THINK C 6.0.
Γùè 1.0 - First public release.
• Thanks to…
Γùè Valentina Pavia, who waited patiently until late at night;
Γùè Alberto Ricci, for his beta-testing and suggestions;
Γùè Fabrizio Oddone, for the text searching code and for his help;
Γùè Masatsugu Nagata, for his invaluable beta testing;
Γùè David Salzman, who had many of the ideas that gave birth to version 2.0;
Γùè Leroy Chen, who didnΓÇÖt stop using List Files 1.1 even though it only provided a ΓÇ£pretty pathetic wayΓÇ¥ to generate volume lists;
Γùè All those who registered for List Files and for my other shareware; they are now way too many to be listed, but this program wouldnΓÇÖt be here without them.
ΓÇó Disclaimer
Γùè List Files should never cause any damage, but youΓÇÖre using it at your own risk. As an independent software developer, I can make no warranties whatsoever on it.
ΓÇó Have fun!
Γùè And donΓÇÖt forget to register your copy of List Files, so that more cool utilities will see the light in the future at the low costs of shareware.
